home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / dev / gcc / gcc270_readme.lha / gnu / gcc-faq.txt < prev    next >
Text File  |  1995-08-21  |  70KB  |  1,810 lines
  1.                               Amiga GNU CC FAQ
  2.                 Version 0.2
  3.  
  4.     This FAQ is intended to answer most (all, if possible) common questions
  5. concerning the Amiga Port of GCC.  It is divided into the following
  6. subsections:
  7.  
  8. 0.  General Introduction
  9.     a. The FSF, the GNU Project, and the GPL
  10.     b. What GCC has to offer
  11.     c. Hardware and Software requirements
  12. 1.  Obtaining and Installing the Beast
  13.     a. Sources of GCC
  14.     b. The breakdown of the distribution
  15.     c. Installation
  16.     d. Common Problems with the Installation
  17. 2.  Initial problems using GCC
  18.     a. Set your stack properly
  19.     b. Amiga specific library options
  20.        i) ixemul.library
  21.        ii) libnix
  22.        iii) libamiga.a and others
  23.     c. The object file format of GCC
  24.     i) Converting libraries to this format
  25.     d. Getting the Commodore includes
  26.     e. The frontend of the compiler 
  27.     f. Optimization may work where no optimization doesn't
  28.     g. Using the OS functions (an example)
  29. 3.  Amiga-specific extensions
  30.     a. The CHIP keyword  (not currently implemented)      
  31.     b. Command Line options
  32.        i) -noixemul   (maybe goes in 2. (b))
  33.        ii) -fbaserel
  34.        iii) -resident
  35.        iv)  Any more?
  36.     c. Startup Code options
  37. 4.  Advanced Questions
  38.     a. How do I build a cross-compiler?
  39.     b. Working with AmiTCP
  40.     c. Writing code for ixemul.library
  41.     d. Writing code for libnix
  42.     f. Saving some RAM
  43.     g. Writing shared libraries and resident (pure) code
  44.     h. I want to change over from SAS/C to GCC
  45.     i. Inline Headers
  46.     j. Writing Hooks
  47. 5.  C++ and Objective C
  48.     (don't know much about these, except that they're not as well
  49.      developed yet as the C compiler)
  50. 6.  Notes for Un*x Hackers
  51.     a. fork() is not implemented
  52. 7.  Support Utilities
  53.     a. Frontends
  54.     b. Debuggers  
  55.     c. What else?
  56. 8.  Additional Support 
  57.     a. amiga-gcc-port mailing list
  58.     b. snail mail (?)  - for people getting it off of CD-ROM
  59.     c. You never know, it could be a problem in base FSF code
  60.     (is there a newsgroup to point to here?)
  61. 9.  Known Bugs
  62.     a. the C compiler
  63.         i) -resident option
  64.         ii) -fbaserel option
  65.     b. the C++ compiler
  66.     c. the Objective C compiler
  67. 10. Maintainers and Contributors
  68. 11. Future
  69. 12. History
  70. Appendix A: How does the GPL affect programs compiled by GCC?
  71. Appendix B: GNU ports and who's dealing with them
  72. Appendix C: Another free C compiler (for those with little memory)
  73.  
  74. Section 0, General Introduction
  75. -------------------------------
  76.  
  77. a.  The FSF, the GNU Project, and the GPL
  78.     The Free Software Foundation (FSF) is an institution dedicated to
  79. the free flow of software (and information in general (?)).  To this end
  80. it has start the GNU (GNU's Not Unix) project, a collection of widely
  81. portable software of all sorts (compilers and Un*x utilities for the 
  82. most part, but some other stuff as well).  But I'm sure Richard Stallman,
  83. director and founder of the FSF, can say it better than I:
  84. [Note that this is heavily clipped;  You should get the original at
  85. prep.mit.edu]
  86.  
  87. ----------------------------------------------------------------------
  88. Copyright (C) 1985, 1993 Free Software Foundation, Inc.
  89.  
  90.  
  91.  
  92. The GNU Manifesto
  93. *****************
  94.  
  95.  
  96. Why I Must Write GNU
  97. ====================
  98.  
  99.    I consider that the golden rule requires that if I like a program I
  100. must share it with other people who like it.  Software sellers want to
  101. divide the users and conquer them, making each user agree not to share
  102. with others.  I refuse to break solidarity with other users in this
  103. way.  I cannot in good conscience sign a nondisclosure agreement or a
  104. software license agreement.  For years I worked within the Artificial
  105. Intelligence Lab to resist such tendencies and other inhospitalities,
  106. but eventually they had gone too far: I could not remain in an
  107. institution where such things are done for me against my will.
  108.  
  109.    So that I can continue to use computers without dishonor, I have
  110. decided to put together a sufficient body of free software so that I
  111. will be able to get along without any software that is not free.  I
  112. have resigned from the AI lab to deny MIT any legal excuse to prevent
  113. me from giving GNU away.
  114.  
  115. Why GNU Will Be Compatible with Unix
  116. ====================================
  117.  
  118.    Unix is not my ideal system, but it is not too bad.  The essential
  119. features of Unix seem to be good ones, and I think I can fill in what
  120. Unix lacks without spoiling them.  And a system compatible with Unix
  121. would be convenient for many other people to adopt.
  122.  
  123. How GNU Will Be Available
  124. =========================
  125.  
  126.    GNU is not in the public domain.  Everyone will be permitted to
  127. modify and redistribute GNU, but no distributor will be allowed to
  128. restrict its further redistribution.  That is to say, proprietary
  129. modifications will not be allowed.  I want to make sure that all
  130. versions of GNU remain free.
  131.  
  132. Why Many Other Programmers Want to Help
  133. =======================================
  134.  
  135.    I have found many other programmers who are excited about GNU and
  136. want to help.
  137.  
  138.    Many programmers are unhappy about the commercialization of system
  139. software.  It may enable them to make more money, but it requires them
  140. to feel in conflict with other programmers in general rather than feel
  141. as comrades.  The fundamental act of friendship among programmers is the
  142. sharing of programs; marketing arrangements now typically used
  143. essentially forbid programmers to treat others as friends.  The
  144. purchaser of software must choose between friendship and obeying the
  145. law.  Naturally, many decide that friendship is more important.  But
  146. those who believe in law often do not feel at ease with either choice.
  147. They become cynical and think that programming is just a way of making
  148. money.
  149.  
  150.    By working on and using GNU rather than proprietary programs, we can
  151. be hospitable to everyone and obey the law.  In addition, GNU serves as
  152. an example to inspire and a banner to rally others to join us in
  153. sharing.  This can give us a feeling of harmony which is impossible if
  154. we use software that is not free.  For about half the programmers I
  155. talk to, this is an important happiness that money cannot replace.
  156.  
  157. How You Can Contribute
  158. ======================
  159.  
  160.    I am asking computer manufacturers for donations of machines and
  161. money.  I'm asking individuals for donations of programs and work.
  162.  
  163.    One consequence you can expect if you donate machines is that GNU
  164. will run on them at an early date.  The machines should be complete,
  165. ready to use systems, approved for use in a residential area, and not
  166. in need of sophisticated cooling or power.
  167.  
  168.    I have found very many programmers eager to contribute part-time
  169. work for GNU.  For most projects, such part-time distributed work would
  170. be very hard to coordinate; the independently-written parts would not
  171. work together.  But for the particular task of replacing Unix, this
  172. problem is absent.  A complete Unix system contains hundreds of utility
  173. programs, each of which is documented separately.  Most interface
  174. specifications are fixed by Unix compatibility.  If each contributor
  175. can write a compatible replacement for a single Unix utility, and make
  176. it work properly in place of the original on a Unix system, then these
  177. utilities will work right when put together.  Even allowing for Murphy
  178. to create a few unexpected problems, assembling these components will
  179. be a feasible task.  (The kernel will require closer communication and
  180. will be worked on by a small, tight group.)
  181.  
  182.    If I get donations of money, I may be able to hire a few people full
  183. or part time.  The salary won't be high by programmers' standards, but
  184. I'm looking for people for whom building community spirit is as
  185. important as making money.  I view this as a way of enabling dedicated
  186. people to devote their full energies to working on GNU by sparing them
  187. the need to make a living in another way.
  188.  
  189. Why All Computer Users Will Benefit
  190. ===================================
  191.  
  192.    Once GNU is written, everyone will be able to obtain good system
  193. software free, just like air.(2)
  194.  
  195.    This means much more than just saving everyone the price of a Unix
  196. license.  It means that much wasteful duplication of system programming
  197. effort will be avoided.  This effort can go instead into advancing the
  198. state of the art.
  199.  
  200.    Complete system sources will be available to everyone.  As a result,
  201. a user who needs changes in the system will always be free to make them
  202. himself, or hire any available programmer or company to make them for
  203. him.  Users will no longer be at the mercy of one programmer or company
  204. which owns the sources and is in sole position to make changes.
  205.  
  206.    Schools will be able to provide a much more educational environment
  207. by encouraging all students to study and improve the system code.
  208. Harvard's computer lab used to have the policy that no program could be
  209. installed on the system if its sources were not on public display, and
  210. upheld it by actually refusing to install certain programs.  I was very
  211. much inspired by this.
  212.  
  213.    Finally, the overhead of considering who owns the system software
  214. and what one is or is not entitled to do with it will be lifted.
  215.  
  216.    Arrangements to make people pay for using a program, including
  217. licensing of copies, always incur a tremendous cost to society through
  218. the cumbersome mechanisms necessary to figure out how much (that is,
  219. which programs) a person must pay for.  And only a police state can
  220. force everyone to obey them.  Consider a space station where air must
  221. be manufactured at great cost: charging each breather per liter of air
  222. may be fair, but wearing the metered gas mask all day and all night is
  223. intolerable even if everyone can afford to pay the air bill.  And the
  224. TV cameras everywhere to see if you ever take the mask off are
  225. outrageous.  It's better to support the air plant with a head tax and
  226. chuck the masks.
  227.  
  228.    Copying all or parts of a program is as natural to a programmer as
  229. breathing, and as productive.  It ought to be as free.
  230.  
  231. ---------------------------------------------------------------------
  232.  
  233.  
  234. The GNU Public License (GPL) was written in order to keep software published
  235. under it free.  Here's the Preamble of the GPL:
  236.  
  237. ---------------------------------------------------------------------
  238.             GNU GENERAL PUBLIC LICENSE
  239.                Version 2, June 1991
  240.  
  241.  Copyright (C) 1989, 1991 Free Software Foundation, Inc.
  242.                           675 Mass Ave, Cambridge, MA 02139, USA
  243.  Everyone is permitted to copy and distribute verbatim copies
  244.  of this license document, but changing it is not allowed.
  245.  
  246.                 Preamble
  247.  
  248.   The licenses for most software are designed to take away your
  249. freedom to share and change it.  By contrast, the GNU General Public
  250. License is intended to guarantee your freedom to share and change free
  251. software--to make sure the software is free for all its users.  This
  252. General Public License applies to most of the Free Software
  253. Foundation's software and to any other program whose authors commit to
  254. using it.  (Some other Free Software Foundation software is covered by
  255. the GNU Library General Public License instead.)  You can apply it to
  256. your programs, too.
  257.  
  258.   When we speak of free software, we are referring to freedom, not
  259. price.  Our General Public Licenses are designed to make sure that you
  260. have the freedom to distribute copies of free software (and charge for
  261. this service if you wish), that you receive source code or can get it
  262. if you want it, that you can change the software or use pieces of it
  263. in new free programs; and that you know you can do these things.
  264.  
  265.   To protect your rights, we need to make restrictions that forbid
  266. anyone to deny you these rights or to ask you to surrender the rights.
  267. These restrictions translate to certain responsibilities for you if you
  268. distribute copies of the software, or if you modify it.
  269.  
  270.   For example, if you distribute copies of such a program, whether
  271. gratis or for a fee, you must give the recipients all the rights that
  272. you have.  You must make sure that they, too, receive or can get the
  273. source code.  And you must show them these terms so they know their
  274. rights.
  275.  
  276.   We protect your rights with two steps: (1) copyright the software, and
  277. (2) offer you this license which gives you legal permission to copy,
  278. distribute and/or modify the software.
  279.  
  280.   Also, for each author's protection and ours, we want to make certain
  281. that everyone understands that there is no warranty for this free
  282. software.  If the software is modified by someone else and passed on, we
  283. want its recipients to know that what they have is not the original, so
  284. that any problems introduced by others will not reflect on the original
  285. authors' reputations.
  286.  
  287.   Finally, any free program is threatened constantly by software
  288. patents.  We wish to avoid the danger that redistributors of a free
  289. program will individually obtain patent licenses, in effect making the
  290. program proprietary.  To prevent this, we have made it clear that any
  291. patent must be licensed for everyone's free use or not licensed at all.
  292.  
  293.   The precise terms and conditions for copying, distribution and
  294. modification follow.
  295.  
  296. ------------------------------------------------------------------------
  297.  
  298. More information regarding the FSF, GNU, and the GPL can be obtained at
  299. gnu.prep.mit.edu.  Note that the source code of any GPLed software must be
  300. made available by the distributor (is this wording accurate?).  The GPL
  301. may also affect how you distribute your programs, or maybe not.
  302. For more information, check out Appendix A of this FAQ.
  303. (Do this before believing all the bad hype about it.  Then decide for
  304. yourself).
  305.  
  306. b.  What GCC has to offer.
  307.     A FREE C compiler, for starters.  I'm sure there's some other stuff.
  308.     It's available for a wide range of machines (and thus it can't be
  309.     beat for cross-compiling, at least on the Amiga).
  310.     For the interested, a chance to change it as you like, make your own
  311.       bug fixes, be an active part in the development process.
  312.  
  313. c. Hardware and Software Requirements
  314.    This depends upon what you're doing.  Here's an excerpt from Phillipe
  315. Brand's readme for his distribution on the net:
  316.  
  317.  
  318. - Systems:
  319. Any Amiga (ranging from A1000 up to A4000/40, including CD-32 & SX-1) will
  320. run amigados-gnu utilities.
  321.  
  322. - Memory:
  323. A minimum of 4MB free memory is needed in order to compile small/medium
  324. projects.
  325. More memory will be needed for large projects, such as recompiling gcc
  326. itself.
  327. Gigamem is known to work with GCC so *maybe* less memory will work. 
  328. But in this case, you'll need an MMU equiped amiga (A3000,A4000/40, etc...).
  329. VMM40 (Public Domain Virtual memory manager) is also known to work with GCC.
  330.  
  331. [Editor's note:  using the g++ compiler can require even more, like at 
  332.     least  6 MB of free RAM]
  333. - OS:
  334. Starting from this release [2.6.3], 1.3 systems are not longer supported.
  335. Gcc runs fine on all other systems, starting from 2.04 up to 3.1 (40.68).
  336.  
  337. - Disk Space;
  338. An installation of gcc requires the use of a hard disk. Approximately 10MB is
  339. required at present to install the compiler and utilities required to use it.
  340. In addition 3MB is required for the Commodore Developer Kit, which is required
  341. to be able to compile AmigaDOS specific programs. This kit is available direct
  342. from Commodore-Amiga.
  343.  
  344. [Note, this is not true for the FreshFish distribution, which can be run
  345. straight off the CD-ROM if desired.]
  346.  
  347. ----------------------------end quote---------------------------------
  348.  
  349. Yes, it can take a lot of resources, but that's a function of its
  350. portability.  Be glad you can count on having the same compiler on your
  351. Amiga at home or the Unix system at work (or vice versa :-)).  
  352.  
  353. 1.  Obtaining and Installing the Beast
  354. a. Sources of the Amiga port of GCC
  355.    There are a couple of options for getting GCC.
  356.    If you have access to the Internet, and ftp service, you can obtain
  357. the current version of GCC from Aminet, in dev/gcc.
  358. The main site of Aminet is ftp.wustl.edu in /pub/aminet, and has mirrors
  359. world-wide:
  360.                      USA (MO)                ftp.wustl.edu
  361.                      USA (WI)               ftp.netnet.net
  362.                      USA (TX)                 ftp.etsu.edu
  363.                      Scandinavia               ftp.luth.se
  364.                      Switzerland              ftp.eunet.ch
  365.                      Switzerland          ftp.math.ethz.ch
  366.                      Germany        kelly.uni-paderborn.de
  367.                      Germany          ftp.uni-paderborn.de
  368.                      Germany          ftp.uni-stuttgart.de
  369.                      Germany           ftp.uni-erlangen.de
  370.                      Germany           ftp.cs.tu-berlin.de
  371.                      Germany            ftp.tu-chemnitz.de
  372.                      Germany            ftp.fh-augsburg.de
  373.                      Germany             ftp.uni-bremen.de
  374.                      Germany                 ftp.uni-kl.de
  375.                      Germany              ftp.uni-trier.de
  376.                      Germany      ftp.informatik.rwth-aach
  377.                      France                    ftp.cnam.fr
  378.                      Portugal                 ftp.ci.ua.pt
  379.                      UK                   ftp.doc.ic.ac.uk
  380.                      UK                 micros.hensa.ac.uk
  381.  
  382.  
  383.     ftp.funet.fi also serves to act as a hub for porting GNU software to 
  384. the Amiga, and serves to mirror Phillipe Brand's Amiga GCC tree directly, so 
  385. that you may always find GCC there (particularly to guarantee the availability
  386. of source code).
  387.  
  388.    The distribution is broken up into several parts, both to make it
  389. easier to download and to respect the GPL.  Thus each archive is 
  390. broken into two parts, one for binaries and one for sources.
  391.  
  392.  
  393. Gcc-2.6.3 is split up into 15 archives:
  394.  
  395. gcc263-readme.lha    holds readmes files (include installation notes).
  396. gcc263-base.lha         basic gcc distribution, hold necessary files.
  397. gcc263-inclib.lha    headers and libraries.
  398. gcc263-c.lha        C compiler.
  399. gcc263-c-020.lha    68020+68881 version of C compiler.
  400. gcc263-c++.lha        C++ compiler, headers and libraries.
  401. gcc263-c++-020.lha    68020+68881 versions of C++ compiler.
  402. gcc263-objc.lha        Objective-C compiler, header and libraries.
  403. gcc263-objc-020.lha    68020+68881 versions of Objective-C compiler.
  404. gcc263-doc.lha        Gcc AmigaGuide(tm) documents & manpages.
  405. gcc263-utils.lha    Useful utilities needed for development.
  406. gcc263-utilsdoc.lha    Utilities documentation (guide & manpages).
  407. gcc263-texi.lha        All Texinfo documents.
  408. gcc263-diffs.lha    Diff files for all binaries.
  409. gcc263-src.lha        Source for gcc-2.6.3 plus diff file.
  410.  
  411.  
  412.    The second way is to utilize your CD-ROM drive and get one of Fred Fish's
  413. great CD-ROM collections. Any of the FreshFish or GoldFish Vol. 2 will
  414. have it, though the later the CD-ROM the later the version.  He also
  415. includes as many ports of GNU utilities as he can.  His restriction is
  416. simply that the binaries he includes must be compilable from the sources
  417. he includes (this has been a problem in the past, and Fred is a stringent
  418. observer of the GPL).  So, yes, you also get all the sources with the
  419. binaries.  (If you've got a CD-ROM drive, you should get one of these 
  420. anyway; it's a great deal).
  421.    These CD-ROMs may be purchased from Amiga Library Services by:
  422. Snail Mail:  Amiga Library Services
  423.          610 N. Alma School Road, Suite 18
  424.          Chandler, AZ   85224-3687
  425.          USA
  426. FAX or Voice: (602) 491-0048
  427. Phone:           (800) 804-0833
  428. or Email:    orders@amigalib.com
  429. (but sending credit card information over e-mail is not secure, so one
  430. of the other methods would be preferable.  Fred is working on using some
  431. kind of encryption though.  More details when they're available.)
  432.  
  433.    There may be other CD-ROMs containing GCC, I just know of Fred's since
  434. he is directly involved in the porting of it.
  435.    The breakdown of this distribution is different.  Check the specific
  436. CD-ROM for details.  They also include the Commodore Native Developer
  437. Updates (no Autodocs) for 2.04, 3.0, and 3.1, which is a big bonus.  
  438.    
  439. c.  Installation
  440.     Installation procedures may vary depending on your source, but
  441. the final directory structure should be the same.  Check the README
  442. files included in your distribution package for more details.  
  443.     
  444.     The ftp distribution (Phillipe Brand's) contains an Installer program.
  445.     It utilizes the following layout:
  446.  
  447. Name            What                    Where    
  448. ----            ----                    -----
  449.  
  450. COPYING            GNU LICENSE, read!!            All archives
  451. COPYING.LIB        GNU LIBRARY LICENSE, read!!        All archives
  452. README-2.6.3        this file                All archives
  453. NEWS-2.6.3        What's new in gcc-2.6.3            gcc263-base
  454. Installer        Commodore installer utility        gcc263-base
  455. GCC-Install        Installer script to configure gcc    All archives
  456. envarc/            global environment variables you should
  457.             have set when using this programming    gcc263-base
  458.             environment
  459. include/        non-amiga specific C/C++ headers    gcc263-inclib
  460. os-include/proto    amiga specific protos headers.        gcc263-inclib
  461. os-include/inline    amiga specific inline C headers. Add    gcc263-inclib
  462.             Commodore headers!!        
  463. os-lib/            amiga specific libraries        gcc263-base
  464. guide/            Docs in AmigaGuide(tm) format        gcc263-doc
  465. man/            this is the root for tons of man pages    gcc263-doc
  466. bin/            this is /bin, and contains all         gcc263-c
  467.             binaries of this distribution that    gcc263-c++
  468.             are meant to be directly invoked by    gcc263-utils
  469.             the user (contrary to the executables
  470.                  in lib/gcc-lib/, that are meant to be
  471.             invoked by a driver program like gcc)
  472. lib/            normal (not base relatives) libraries    gcc263-inclib
  473. lib/libm020/        normal 68020 libraries            gcc263-inclib
  474. lib/libb/        base relatives libraries        gcc263-inclib
  475. lib/libb/libm020/    base relatives using 68020 libraries    gcc263-inclib
  476. lib/libnix/        Non-ixemul libraries            gcc263-inclib
  477. lib/libm020/libnix/    Non-ixemul 68020 libraries        gcc263-inclib
  478. lib/libb/libnix/    Non-ixemul base relatives libraries    gcc263-inclib
  479. lib/libb/libm020/libnix    Non-ixemul base relatives 68020 libs    gcc263-inclib
  480. lib/gcc-lib/        home of compilers called by gcc        gcc263-c
  481.                                 gcc263-c++
  482.                                 gcc263-objc
  483. ixpipe/            a pipe handler needed by the library    gcc263-base
  484. libs/            ixemul.library                gcc263-base
  485. rexx/            ARexx wrappers for gcc and g++        gcc263-base
  486. src-patches/        source patches                gcc263-diffs
  487. geninline/        Perl scripts to generate inline headers    gcc263-inclib
  488.             and -lamy glue
  489.  
  490.  
  491.     A standard GNU directory tree structure has been adopted by the 
  492. porting team to make life easier for everyone.  Starting with the
  493. assign of GNU: to somewhere, we then have:
  494.  
  495.      GNU:amigados            
  496.      GNU:man
  497.      GNU:Info
  498.      GNU:etc
  499.      GNU:bin
  500.      GNU:include
  501.      GNU:lib
  502.      GNU:os-include
  503.      GNU:os-lib 
  504.  
  505.     Since one of the aims of porting GNU software is to be able to provide
  506. a Un*x like environment under AmigaOS, the porters decided to make a GNU
  507. "root directory" (GNU:) in which a standard Un*x directory tree can live, like
  508. /etc, /bin, and so on.  This decision makes for good Un*x compatibility.
  509.    Also, in the past, you would have to add many assigns (>=10) to have your
  510. GNU utilities working, and now it's just 5 (GNU:, MAN:, INFO:, ETC:, and 
  511. BIN: ).
  512. We no longer have a conflicting assign LIB: (which most other compilers use).
  513.  
  514. d. Common Installation Problems
  515.    Using the Installer program for the ftp distribution should get rid
  516. of these problems.
  517.    Check out the section on the specs file if you are having problems 
  518. customizing your installation (say you have another compiler, and don't
  519. want to have 2 separate copies of os-include).
  520.    Also, for those of you who refuse to read the README, you need the 
  521. Commodore includes.  Section 2 (d) tells you where to get them. 
  522.    See 2 (c) about the GCC object format.  You may need to convert some
  523. standard libraries.  Also check 2(a) on setting your stack properly.
  524.  
  525. 2.  Initial Problems with GCC
  526.  
  527. a.  Set your stack properly.
  528.     GCC needs a lot of stack to run.  For a nice, small (<1000 lines)
  529. source, a stack of 50,000 should do just fine.  For more complicated
  530. code, you may need more, but 250,000 should do in any case, for gcc alone.
  531.     Note that using make may increase the demands on the stack size, so
  532. the above suggestions may not hold.
  533.  
  534. A word from Phillipe Brand's README:
  535.  
  536. You need to have a 50.000 stack size in order to compile with GCC. This should
  537. be enough for most projects. Note than while recompiling gcc with itself it
  538. has taken more than 300KB stack. Stack can grow due to source complexity.
  539. Don't be afraid of it.
  540.  
  541. To set the stack size, see the AmigaDOS Command 'stack'. 
  542.  
  543. To use ar and/or ranlib, 50KB is the minimum acceptable. You should have a
  544. much larger stack, if you use larger libraries.
  545.  
  546. Starting with 2.6.3 a new environnement variable, GCCSTACK, enables gcc to
  547. read this variable and set stack upon startup. Thus now no need to set stack
  548. to huge values, only gcc/ld/cpp/cc1#? will automatically set new stack,
  549. according to GCCSTACK variable.
  550.  
  551. Simply commit a: 
  552.     setenv GCCSTACK value
  553. to set gcc stack to value.
  554.  
  555. Benefits: huge memory savings.
  556.  
  557. ----------------end quote
  558.  
  559. Note that GCC 2.7.0 will include automatic stack growth code, so you won't
  560. need to worry about this anymore.
  561.  
  562.  
  563. b. Amiga specific Library options
  564.     i) Ixemul.Library
  565.         This library was developed by Markus Wild when originally started
  566. porting GCC (up to version 2.3.3).  It is a shared library that emulates
  567. a lot of Un*x functions, making life a lot easier for folks porting
  568. GNU utilities and such.  Unfortunately, it is fairly resource hungry by
  569. Amiga standards, and has caused not a little irritation among Amiga
  570. users.  GCC opens ixemul.library by default, so if you want to avoid it, 
  571. you'll have to use -noixemul on the command line (see below in Amiga 
  572. specific extensions and/or coding with x.lib) and link to one of the 
  573. libraries below.
  574.     The general rule of thumb should be to use ixemul.library if you're
  575. writing something non-Amiga specific (e.g. porting something) or one of the
  576. below link libraries when writing something specifically for the Amiga.
  577.  
  578.     Using ixconfig to work:
  579. ----------------------------------
  580. [Joerg-Cyril Hoehle]
  581.  
  582. > Which ixconfig should we use for ixemul v40.4?
  583.  
  584. If you're using R.Luebbert ixem404lib.lha, use ixconfig from
  585. there. It's actually called bin in that archive :-(
  586. [generic]            2925    5396  54.2% -lh5- b464 Sep  3  1994 ixem/bin
  587.  
  588. The ixemul.library from the gcc263 archive is R.Luebbert's 40.4.
  589.  
  590. If you're using another one:
  591.  
  592. Fred Fish's: I don't know whether he removed the ArpBase field in the
  593. include/library/ixemul.h file. R.Luebbert removed it between his 40.2
  594. and 40.4, which was a big mistake IMHO (as this mail and others
  595. show). So I don't know which ixconfig is good for him.
  596.  
  597. Leonard's: He told me that he had never removed this field, so get any
  598. old ixconfig you'll find. The one from the gcc263 archive will do.
  599.  
  600.  
  601.  
  602.      ii) libnix
  603.          This is a standard link library to replace the functionality of
  604. ixemul.library. Make sure you link to it if you use the -noixemul command
  605. line option for gcc.  Here's the readme file from the distribution:
  606.  
  607. Short: A library for amiga specific development on gcc
  608. Type: dev/gcc
  609. Uploader: fleischr@izfm.uni-stuttgart.de
  610. Author: fleischr@izfm.uni-stuttgart.de, gnikl@informatik.uni-rostock.de
  611.  
  612. This is libnix, a static (i.e. link) library for gcc 2.3.3 or above.
  613. It's not a replacement for ixemul.library (though it's possible to
  614. recompile most of the gcc environment with libnix) but a good thing
  615. for amiga specific development on gcc:
  616.  
  617. * It's mostly compatible to SAS's way of handling things, i.e.
  618.   you get even an automatic shared library opening feature and
  619.   some other things you may miss in ixemul.library.
  620.   This also means it's ANSI compliant.
  621.  
  622. * It doesn't need any shared libraries than normal Amiga OS ones.
  623.  
  624. * It is not copyrighted by the FSF. Therefore you neither need
  625.   to include sources nor objects together with your executable.
  626.   (read the GLGPL _before_ flaming on this statement)
  627.  
  628. * And it's short! I was able to compile a 492 byte 'hello, world'
  629.   using normal main.
  630.  
  631. * It uses OS20 features whenever necessary.
  632.  
  633. To cut it short:
  634.  
  635. Use ixemul.library for porting Un*x programs, libnix for compiling
  636. amiga-only programs and gcc becomes one of the best Amiga compilers.
  637.  
  638. There is no need to download this archive if you use gcc2.6.0 or above
  639. since the libraries itself are included with the normal gcc distribution.
  640.  
  641. But if you use an older gcc version or if you want to get the sources
  642. you can take this package. But be warned: The ld that comes with earlier
  643. versions of gcc has some serious trouble with set elements. You cannot
  644. use libnix without the fixed linker that comes with gcc2.6.0.
  645.  
  646.  
  647.      iii) Gerlib
  648.           Obsolete
  649.  
  650.      iv) the PDC library   
  651.           Obsolete 
  652.  
  653. c.  The object file format of GCC
  654.      
  655.      Yes, GCC uses its own object file format.  This means you aren't 
  656. currently able to link to AmigaDOS hunk format object files (standard).  
  657. But hunk2gcc (by Markus Wild) will do the conversion for you as described 
  658. below.
  659.  
  660.    Why does GCC use its own object file format?  It's really just a design
  661. decision that allows other gnu utilities to deal with these objects (for 
  662. example, gdb) without having to convert them to deal with AmigaDOS hunks. 
  663.  
  664. >From Brand's README-2.6.3
  665.  
  666. Starting from this release an AmigaDOS compliant library is provided,
  667. thanks to libnix authors (Matthias Fleischer and Gunther Nikl).
  668.  
  669. Anyway if you want to rebuild one, there are two methods:
  670.  
  671. 1) Using hunk2gcc; the AmigaDOS object converter made by Markus Wild. To
  672. achieve this, simply grab a copy of latest amiga.lib (from Commodore
  673. Development Kit) and make a new directory where you want your converted
  674. object files to go, cd into it, and enter
  675.  
  676.   hunk2gcc amiga.lib [..further libs if you like..]
  677.  
  678. This generates an a.out object file for every program unit present in the
  679. hunk file (in this case, from amiga.lib).
  680.  
  681. As the final step convert all those files into an a.out style library by
  682. issuing:
  683.  
  684.   ar qc libamiga.a obj.*
  685.   ranlib libamiga.a
  686.  
  687. The ranlib run builds a symbol table in the archive, and makes accesses to
  688. the library much faster.
  689.  
  690. 2) Creating a libamiga.a library with libnix is fairly easy, but takes some
  691. time. Just uncompress sources.lha from libnix distribution and run a
  692. 'make libamiga.a'.
  693.  
  694. NOTE:
  695.  
  696. As long as you make no AmigaDOs specific calls, you can create a dummy library
  697. using:
  698.  
  699.   cat "int dummy;" >dummy.c
  700.   gcc -c dummy.c
  701.   ar crv libamiga.a dummy.o
  702.   mv libamiga.a gcc:lib
  703.  
  704. A small libamiga.a (dummy) is also provided with libnix.
  705.  
  706.  
  707.     d. Getting the Commodore includes
  708. [Jochen Wiedmann]
  709.  
  710. You can obtain the includes and some developer tools from any Fish CD
  711. and some other CD's as well.
  712.  
  713. However, you will be missing the autodocs, which are definitely the
  714. best information source for the OS functions. You can get them either
  715. by buying the
  716.  
  717.     The Amiga ROM Kernel Manual:  Includes and Autodocs, ISBN
  718.                                                           0-201-56773-3
  719.  
  720. (about 50-60$, as far as I know), or by buying the so-called NDU
  721. (Native developers update kit, 5 disks, about 40$) from
  722.  
  723.          Fa. Hirsch & Wolf
  724.          Mittelstr. 33
  725.          56564 Neuwied
  726.      Germany
  727.  
  728.          Phone: (0049) +2631 83990
  729.      Email: hhhirsch@carla.adsp.sub.org
  730.  
  731. Sorry, but this is still the *only* source for the NDU, at least as
  732. long as CATS (Commodore Amiga Technical Support) isn't alive.
  733.  
  734. I'd prefer buying the NDU, because it contains the newer information
  735. than the book and I prefer it online.
  736.  
  737.  
  738.  
  739.     e. The frontend of the compiler 
  740.          amigados-gcc and gcc are the same thing.
  741.          AREXX scripts:
  742.  
  743. The provided ARexx scripts have been contributed by Loren J. Rittle.
  744. If you like ARexx, they're an alternate way of calling gcc. They 
  745. automatically make sure you're using a large enough stack setting, and 
  746. enable you to compile C++ programs with less obscure options. This 
  747. approach is furthermore useful if you're not able to use the g++ /bin/sh
  748. script.
  749.  
  750.     f. Optimization may work where no optimization doesn't
  751.          The folks who write GCC almost always use -O when compiling
  752. GCC and other stuff.  Hence, the -O routines are better tested than
  753. those without optimization.  So you may want to try it.
  754.  
  755. g.) Using the OS functions with gcc.
  756.  
  757. [Jochen Wiedmann, with a small suggestion by Christian Stieber]
  758.  
  759. Let's write a simple "HelloWorld.c":
  760.  
  761.     /*  Compile me with
  762.         gcc -noixemul -o HelloWorld HelloWorld.c -lauto
  763.     */
  764.     #include <stdlib.c>
  765.     #include <intuition/intuition.h>
  766.     #include <proto/intuition.h>
  767.  
  768.     int main(int argc, char *argv[])
  769.  
  770.     {
  771.         struct EasyRequest er;
  772.  
  773.         er.es_StructSize = sizeof(er);
  774.         er.es_Flags = 0;
  775.         er.es_Title = "Message";
  776.         er.es_TextFormat = "Hello, world!\nintuition.library is at 0x8l.";
  777.         er.es_GadgetFormat = "Ok";
  778.         EasyRequest(NULL, &er, NULL, IntuitionBase);
  779.     exit(0);
  780.     }
  781.  
  782. Some notes:
  783.  
  784.   - We are using the function EasyRequestArgs() from intuition.library. 
  785.     Thus we have to include the appropriate headers: intuition/intuition.h
  786.     for the structures and constants, proto/intuition.h for the 
  787.     function prototypes. Do not use headers from other compilers (for
  788.     example pragmas/intuition.h), gcc headers (inline/intuition.h,
  789.     included by proto/intuition.h) or even OS headers
  790.     (clib/intuition_protos.h). The only exception are clib/alib_protos.h
  791.     and clib/alib_stdio_protos.h: These represent link libraries and not
  792.     shared libraries.
  793.  
  794.   - We did *not* open intuition.library. gcc does this for you by
  795.     including proto/intuition.h and linking against libauto.a.
  796.     However, this works only for OS libraries. Consult the GNU:libauto
  797.     directory, if you want to know how to get the same possibilities for
  798.     other shared libraries.
  799.  
  800.     Using proto/intuition.h you are safe and even source compatible
  801.     to SAS/C and Dice.
  802.  
  803.   - If you *need* to open a library manually, do it as follows:
  804.  
  805.     #include <stdlib.h>
  806.     #include <stdio.h>
  807.         #include <intuition/intuition.h>
  808.     #include <proto/intuition.h>
  809.  
  810.         struct IntuitionBase *IntuitionBase = NULL;
  811.     /*  Explicit initialization with NULL is a *must*!  */
  812.  
  813.     void Cleanup(void)
  814.  
  815.     {
  816.         if (IntuitionBase) CloseLibrary(IntuitionBase);
  817.     }
  818.  
  819.     int main(int argc, char *argv[])
  820.  
  821.     {
  822.         if (atexit(Cleanup)) {
  823.         perror("atexit");
  824.         exit(20);
  825.         }
  826.  
  827.         if (!(IntuitionBase = (struct IntuitionBase *)
  828.             OpenLibrary("intuition.library", 37))) {
  829.         fprintf(stderr, "Cannot open intuition.library, V37");
  830.         exit(20);
  831.         }
  832.  
  833.         /* Same program as above */
  834.     }
  835.  
  836.      Note the use of atexit(), which makes exit() calling Cleanup().
  837.  
  838. Note this possible alteration:
  839.  
  840. >         struct EasyRequest er;
  841. > 
  842. >         er.es_StructSize = sizeof(er);
  843.  
  844. This seems to be correct, but I suggest hardcoding 5*sizeof(ULONG) here.
  845. That field serves as version information; using sizeof() and compiling
  846. with newer headers would tell the OS that you're using the new structure.
  847. But the additional fields will contain garbage...
  848.  
  849.  
  850. 3.  Amiga-specific extensions
  851.  
  852.     a. The CHIP keyword      
  853.  
  854.     Most C compilers for the Amiga have a CHIP keyword or equivalent to
  855. signify that an object should stored CHIP memory when declared.  I.e., 
  856. CHIP struct Image *my_graphics = { ... } 
  857. will cause the memory for the data to which my_graphics points to be allocated
  858. in CHIP memory (pretty handy, huh?)
  859.     This is obviously Amiga-specific, so of course it's not implemented
  860. in the FSF code. BUT, the linker (ld) currently recognizes -chip and -fast 
  861. options.  However, these haven't been put in gcc itself quite yet, though I 
  862. have been assured they will be here soon (there have been more important 
  863. things to work on, like getting -resident to work again, see below).
  864.          So if you're using 2.6.3 or below, here are some basic work-arounds:
  865.  
  866. (I gotta find these)
  867.  
  868.     b. Command Line options
  869.  
  870.        i) -noixemul   (maybe just reference 2. (b))
  871.               This option prevents gcc from making your executable open
  872. ixemul.library (of course, your program can still do so).  Make sure you
  873. link to libnix or something similar to access those functions.
  874.            See also 2. (b) (ii)
  875.  
  876.        ii) -fbaserel (currently broken until 2.7.0)
  877. [from Christian Stieber]
  878.             -fbaserel turns on base relative adressing; which means that 
  879. global/static variables are referenced with a 16 bit offset relative to an 
  880. address register (a4 is generally used for that). The startup-code loads a4 
  881. with a pointer into the data segment. Result: every access to a global/shared
  882. variable is only 16 bit instead of the usual 32 bit address -> shorter & 
  883. faster. It also means that you're limited to at most 64K of global/static 
  884. variables.
  885.  
  886.        iii) -resident
  887. [from Christian Stieber] 
  888.            A "resident" program (the correct term is "pure") is a program that
  889. can be loaded into memory just once, but executed by serveral processes
  890. at the same time. Therefore, "resident" is actually "code sharing".
  891. -resident turns on -fbaserel and links with a special startup code.
  892. That first thing that special startup code is to allocate some memory,
  893. copy the global/static variables into it and load a4 with a pointer to
  894. that memory. Then, a normal startup-code and your normal program
  895. is run. When the program exists, the memory block is freed.
  896. Result: Every process has its very own, private data segment for
  897. global/static variables. Since there all global/static variables are
  898. accessed via a4+16-bit-offset (because of -fbaserel), the original
  899. data segment is untouched. Result: the program can be executed
  900. independently by several processes, with every process getting its
  901. own data segment.
  902.  
  903.  
  904.     c. Startup Code options  (may be redundant)
  905.  
  906. 4.  Advanced Questions
  907.  
  908.     a. How do I build a cross-compiler?
  909. [from Phillipe Brand]
  910.  
  911. How to generate a cross-compiler, AmigaDOS side:
  912. ------------------------------------------------
  913.  
  914. - Get gcc-2.6.3.tar.gz from ftp.gnu.ai.mit.edu or mirror site
  915. - Get ftp.telesys-innov.fr:/pub/amigados-gnu/gcc-2.6.3-amiga.diffs file
  916.  
  917. >From CLI:
  918.  
  919. CLI> sh
  920. # zcat gcc-2.6.3.tar.gz | tar xvf -
  921. # cd gcc-2.6.3
  922. # zcat ../gcc-2.6.3-amiga.diffs | patch -p1
  923. # ./configure --host=amigados --target=CPU-COMPANY-SYSTEM
  924. # make
  925.  
  926. When compilers are built, all you have to do is installing it using
  927. make install, and to grab other architecture's libraries (libc.a, etc...),
  928. and headers.
  929.  
  930. More infos: See GCC AmigaGuide documentation, look for "Cross-Compiling".
  931.  
  932. How to generate a cross-compiler, Other architecture side:
  933. ----------------------------------------------------------
  934.  
  935. - Get gcc-2.6.3.tar.gz from ftp.gnu.ai.mit.edu or mirror site
  936. - Get ftp.telesys-innov.fr:/pub/amigados-gnu/gcc-2.6.3-amiga.diffs file
  937.  
  938. >From CLI:
  939.  
  940. CLI> sh
  941. # zcat gcc-2.6.3.tar.gz | tar xvf -
  942. # cd gcc-2.6.3
  943. # zcat ../gcc-2.6.3-amiga.diffs | patch -p1
  944. # ./configure --target=amigados (host should be determined by configure itself)
  945. # make
  946.  
  947. When compilers are built, all you have to do is installing it using
  948. make install, and to grab AmigaDOS GCC libraries (libc.a, etc...),
  949. and headers.
  950.  
  951. More infos: See GCC AmigaGuide documentation, look for "Cross-Compiling".
  952.  
  953. A working example of a cross-compiler running on sunos4.1.3 can be found
  954. in ftp.telesys-innov.fr:/pub/amigados-gnu/gcc-cross/....
  955.  
  956.  
  957.     b. Working with AmiTCP
  958.  
  959. > Could somebody please explain where exactly gcc and the libraries
  960. > that come with it fall down when it comes to using AmiTCP?
  961. > 
  962. > What's missing etc.
  963. > 
  964. > Then, Why can't (I assume you can't since veryone says you can't)
  965. > use the C= Developers kit with gcc without fiddling.
  966.  
  967. The problems are:
  968.  
  969. a) gcc uses it's own object module and library format, so lots of the GNU
  970. tools don't have to change too. 
  971.  
  972. b) gcc uses ixemul by default, which is not compatible directly with the SAS
  973. libraries supplied with AmiTCP. 
  974.  
  975. a) is just a design decision, and indeed there are tools to convert. (b) is
  976. harder to see; basically the SAS AmiTCP libraries assume the environment of
  977. SAS/C, complete with references to the SAS FILE structure internals and the
  978. functions which aren't in SAS or which need to be patched to work with
  979. AmiTCP. In addition, the netincludes supplied with the AmiTCP port include
  980. many items and structure definitions which are also defined in gcc, albeit
  981. differently, resulting in a very confised compiler if you mix them. 
  982.  
  983. Unfortunately, a simplistic port (recompile with the right -I directives)
  984. fails for two reasons; the includes are wrong, and even if they were matched,
  985. the SAS-directed library patches the wrong things. Resulting in an executable
  986. which will fail to operate as expected (it might work OK, or it might not -
  987. depends what you call & when). 
  988.  
  989. What is needed is a new library - take out the duplicate definitions, patch
  990. the right functions and remake the library for gcc. 
  991.  
  992. Does this help? 
  993.  
  994. Peter Ivimey-Cook.
  995.  
  996.  
  997.     c. Writing code for ixemul.library
  998.          After looking at Markus Wild's README, I couldn't see anything
  999. to include in particular, and the thing is way too long to put here.
  1000. Any specific suggestions of stuff to clip out?
  1001.  
  1002.          Actually, considering the update activity, the current maintainers/
  1003. developers should be providing a new README.  Particularly the functions
  1004. available in the different versions (regular fxns, the ones in the network
  1005. version, and the conflicts.  Somebody recently answered a question about
  1006. this last part, saying he was trying to integrate the 2).      
  1007.  
  1008.             i)  Finding bugs with trace()
  1009.  
  1010. [Joerg-Cyril Hoehle]
  1011. more than one year ago, I corrected a huge bug in the program trace (a
  1012. buffer overflow). Together with ixemul.trace, this program allows you
  1013. to see every ixemul call (aka SnoopDOS for ixemul.library programs)
  1014. and may be useful for debugging.
  1015.  
  1016. Before, because of that overflow, trace hung the whole system very
  1017. often (and very soon) when tracing every ixemul call. Now, I've been
  1018. able to trace long sessions of gcc compilation to a (K)CON: window
  1019. without trouble.
  1020.  
  1021.  
  1022.  
  1023.     d. Writing code for libnix
  1024.         Maybe a referral to the libnix docs in the source file, or should
  1025. I stick them in here (I believe they're only in the source archive, so people
  1026. may tend not to grab it)?
  1027.  
  1028.      e.  Problems with asm() 
  1029.  
  1030. [Insert your answer here,please]
  1031.  
  1032.  
  1033.      f. How do I save RAM?
  1034. [Jochen Wiedmann]
  1035.  
  1036. A simple try is to do a
  1037.  
  1038.     setenv TMP MyHardDrive:t
  1039.  
  1040. before compiling. This will create temporary files on the harddisk and
  1041. not in RAM. Depending on what you compile this can save some 100K of
  1042. RAM while compiling and it doesn't slow down the compiler very much.
  1043.  
  1044. Another try is to turn off optimization. This prevents the "inline"
  1045. headers from being included, which need *very* much RAM. If you like
  1046. optimization (for example because of the additional checks!) you can
  1047. use the options
  1048.  
  1049.     -O -D__NOINLINES__
  1050.  
  1051. which turn on optimization, but prevent the inline headers from being
  1052. included. (The negative effect is, that you need an additional
  1053. function call any time, you use an OS function, but one can live with
  1054. it.)
  1055.  
  1056.     g. Writing shared libraries and resident (pure) code
  1057.  
  1058. Here is some discussion from the amiga-gcc-port mailing list 
  1059. [not cooked up yet]
  1060.  
  1061. [Peter Ivimey-Cook]
  1062.  
  1063. > Obviously there must be other solutions. Being able to build a library
  1064. > is not far away from being able to build a pure (=residentable)
  1065. > program, and gcc-2.3.3 was both largely above 64KB in size and
  1066. > residentable. So what's the trick?
  1067. > 
  1068.  
  1069. Don't use global data referenced absolutely! residentable implies 
  1070. reentrant, which means that global data is read-only apart from the first 
  1071. instance (i.e. it's OK to initialise it, once, but once initialised it 
  1072. can't be modified or reinitialised). This effectively means the only data 
  1073. used in the must be on the stack or referenced from it by pointers, as 
  1074. the stack is separate for different invocations of a resident program.
  1075.  
  1076. Of course this does pose a major headache for programs which use lots of 
  1077. global data. And watch out for library use too!
  1078.  
  1079. Failing this, one must use a global data access mechanism which allows:
  1080.  
  1081. (a) the base address to be set up - e.g. by calling AllocMem() and 
  1082. storing the result in a register (NOT a global!)
  1083.  
  1084. (b) *all* accesses to "global" data are relative to this register.
  1085.  
  1086. [Peter Ivimey-Cook]
  1087. > 
  1088. > BUT: If we build a shared lib from the static link lib, code exists only once
  1089. > and is SHARED between callers of the lib (callers means different executables, using the lib)
  1090. > Here the problem comes up that the DATA MUST not be shared between different callers.
  1091. > This is because it is PRIVATE to the individual caller.
  1092. > IMHO the only way to realize multiple callers is the use of -fbaserel, since now access
  1093. > is relative to the A4 register and thus, every program can have IT'S OWN data, without
  1094. > interferring with each other.
  1095.  
  1096. It depends on the way the library is constructed. Most Amiga libraries 
  1097. are written to be re-entrant - i.e. they don't use global data items 
  1098. which would require loading - they use the stack. For items which can't 
  1099. be done this way, there are two solutions -
  1100.  
  1101. 1. Use the library data space. It's global, unless you make provision for 
  1102. it to be otherwise - and availabl easily off a6.
  1103.  
  1104. 2. Manage your own data space, using tags or whatever to allocate space 
  1105. for callers. Note that the only indication you have as to who is the 
  1106. current caller is the result of FindTask(). 
  1107.  
  1108. So, in general libraries try to make required data passed through 
  1109. parameters, or available on the stack, or shareably global. In which case 
  1110. no baserel or anything else is required.
  1111.  
  1112.  
  1113. [Jochen Wiedmann]
  1114.   - Of course it is possible to write shared libraries (ixemul.library,
  1115.     for example) with gcc, but *only* if the source is written with a
  1116.     shared library in mind.
  1117.  
  1118.   - It is possible (Matthias told how) to develop a solution that would
  1119.     allow to use existing source of link libraries for shared libraries
  1120.     (libbfd sources, for example) with at most very minor modifications
  1121.  
  1122.   - -fbaserel would be a must for the above solution. On the other hand
  1123.     it is not possible yet, at least not without going to the assembler
  1124.     level. (Really deep, not just using some headers with asm keywords.)
  1125.  
  1126. [Christian Stieber]
  1127. > Jochen Wiedmann writes:
  1128. >  >   - Of course it is possible to write shared libraries (ixemul.library,
  1129. >  >     for example) with gcc, but *only* if the source is written with a
  1130. >  >     shared library in mind.
  1131. > 
  1132. > Could you elaborate on that so that we know a little more about it,
  1133. > please?
  1134.  
  1135. - keep in mind that all callers use the same global and static variables;
  1136.   that means: either protect them with semaphores (e.g. if your library
  1137.   is using a memory pool), or allocate a block of memory inside your library
  1138.   and pass pointers around.
  1139.  
  1140. - the "startup" code will contain the ROMTag structure and related data,
  1141.   as well as stubs to push parameters on the stack, calling the C function,
  1142.   cleaning up the stack.
  1143.  
  1144. - I generally write the libOpen(), libClose(), libInit() etc. functions
  1145.   as normal C functions, but some people might prefer to put them into
  1146.   the "startup code".
  1147.  
  1148. That's about all. It also means that many link-lib functions (e.g. from
  1149. libnix) can't be used; this has to be decided on a per-function basis.
  1150. It's pretty safe to say that you can't use stdio and malloc(). strcpy(),
  1151. isdigit() are safe, etc. Just be careful. Think about what the function does;
  1152. that should give you an idea whether you can use it or not.
  1153.  
  1154. [Jochen Wiedmann]
  1155.  
  1156. > Jochen Wiedmann writes:
  1157. >  >   - Of course it is possible to write shared libraries (ixemul.library,
  1158. >  >     for example) with gcc, but *only* if the source is written with a
  1159. >  >     shared library in mind.
  1160. > 
  1161. > Could you elaborate on that so that we know a little more about it,
  1162. > please?
  1163. > 
  1164. > Does it mean that you can't use any global variable? Or only one but
  1165. > declare it with something like__asm__("a4") and use it as a base
  1166. > pointer? Does it imply that you must use the inline/*.h? Does it imply
  1167. > that you must use a special startup code (of course :-), what must it
  1168. > do?
  1169.  
  1170. In short: You may well use something like
  1171.  
  1172.   struct ExecBase *SysBase;
  1173.  
  1174. and read this variable from anywhere within your program, because you
  1175. can
  1176.  
  1177.   a) initialize it from the library startup code and
  1178.   b) be sure that it never changes
  1179.  
  1180. but you must not use global or static data otherwise.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.     h.  I want to change from SAS/C to GCC
  1186.  
  1187.         Great!
  1188.  
  1189. [Kriton Kyrimis]
  1190.  
  1191. > I am also wondering if it is possible to link object files that were 
  1192. > created by different conpilers, specifically GCC and SAS. I need to do 
  1193.  
  1194. Try compiling SAS programs using DATA=FAR CODE=FAR, then use the hunk2gcc
  1195. program to convert the object files from amiga format to sun format.
  1196.  
  1197. One problem with this approach would be with floating point code and with
  1198. integer multiplication/division. If you can compile with CPU=68020 (or higher)
  1199. and MATH=68881, then SAS/C will produce inline code, and you will have no
  1200. problem. Otherwise, you'll have to grab the necessary modules from the SAS
  1201. libraries and convert them to sun format as well. (Compiling with the option
  1202. that produces code that uses utility.library, and linking with -lauto might
  1203. alleviate the problem.)
  1204. ----------------------------------
  1205.  
  1206.    And here's a little AREXX program to automagically convert sas libs to
  1207. gcc libs:
  1208.  
  1209. This arexx program is based on help from Philippe BRAND.
  1210.  
  1211.  
  1212. /********************************HISTORY**********************************
  1213. * 18-DEC-94 : DJR : Created                                              *
  1214. **************************************************************************
  1215. *                                                                        *
  1216. * Name      : saslib2libgcc                                              *
  1217. * Author    : David J. Ruscak  ruscakd@polaroid.com                      *
  1218. * Created   : 18-DEC-94                                                  *
  1219. * Purpose   : to convert SAS libraries to GCC libraries                  *
  1220. *                                                                        *
  1221. *************************************************************************/
  1222.  
  1223.  
  1224. /* To convert a SAS library to a GCC format library several steps are
  1225.    involved.
  1226.  
  1227.  1) cd to RAM: Either copy the library to RAM: or give the full path name.
  1228.  
  1229.     EX: gnu:saslib2libgcc X11:lib/Xtnb.lib
  1230.  
  1231.  2) You need the SAS Librarian 'oml' with a version =>  Library
  1232.     otherwise you'll get an error such as 'unknown hunk'.
  1233.  
  1234.  3) You need hunk2gcc, mv, ar and ranlib. If your using gcc you have the
  1235.     fastram, VMM2.1 swap works fine too.
  1236.  
  1237. */
  1238.  
  1239.  
  1240. /* TRACE R */
  1241. SIGNAL ON ERROR
  1242. OPTIONS RESULTS
  1243.  
  1244. IF ~SHOW('l','rexxsupport.library') THEN
  1245.   IF (~ADDLIB("rexxsupport.library",0,-30,0)) THEN
  1246.      DO
  1247.         ECHO "Can't load rexxsupport.library"
  1248.         EXIT 10
  1249.      END
  1250.  
  1251.  
  1252. fullname = ""
  1253.  
  1254. PARSE ARG fullname
  1255.  
  1256. IF fullname  == "" THEN
  1257.    DO
  1258.       ECHO " No Library to convert"
  1259.       ECHO ""
  1260.       ECHO " EX: gnu:saslib2libgcc X11:lib/Xtnb.lib"
  1261.       EXIT 10
  1262.    END
  1263.  
  1264. IF (~EXISTS(fullname)) THEN
  1265.    DO
  1266.       ECHO "Can't find" fullname
  1267.       EXIT 10
  1268.    END
  1269.  
  1270.  
  1271. ADDRESS COMMAND
  1272. /* make 2 directories for object files   */
  1273.  
  1274. IF EXISTS('object') THEN
  1275.    DO
  1276.      ECHO "Directory object exists Please delete or rename it."
  1277.      EXIT
  1278.    END
  1279. 'makedir  object'
  1280.  
  1281. IF EXISTS('object2') THEN
  1282.    DO
  1283.      ECHO "Directory object2 exists Please delete or rename it. "
  1284.      EXIT
  1285.    END
  1286. 'makedir  object2'
  1287.  
  1288. 'oml -oobject 'fullname 'X *' /* SAS Object Librarian  */
  1289.  
  1290.  
  1291. IF EXISTS('object') THEN
  1292.  DO
  1293.    objfiles = SHOWDIR('object','F')              /* list of all object files */
  1294.    nfiles = WORDS(SHOWDIR('object','F'))         /* count of object files    */
  1295.    DO    UNTIL nfiles == 0                /* must be a more efficient way... */
  1296.     'hunk2gcc >NIL: object/'WORD(objfiles,nfiles)   /* convert to GCC object */
  1297.     'mv >NIL: obj.#? object2/'WORD(objfiles,nfiles) /* restore original names*/
  1298.     nfiles = nfiles - 1
  1299.    END
  1300.  END
  1301.  
  1302.  
  1303. 'cd object2' /* directory of converted objects */
  1304. path =  PRAGMA('D','object2')
  1305.  
  1306. IF (INDEX(fullname,':') > 0) THEN    /* strip out assign */
  1307.         fullname = SUBSTR(fullname,LASTPOS(':',fullname) + 1)
  1308.  
  1309. IF (INDEX(fullname,'/') > 0) THEN    /* strip off directories */
  1310.         libname = SUBSTR(fullname,LASTPOS('/',fullname) + 1)
  1311. ELSE
  1312.         libname = fullname
  1313.  
  1314. dot = POS('.',libname)
  1315.  
  1316. gcclibname = 'lib'SUBSTR(libname,1,dot)'a'
  1317.  
  1318. 'ar qc 'gcclibname' #?.o'    /* archive new library */
  1319.  
  1320. 'ranlib 'gcclibname
  1321.  
  1322. IF EXISTS(gcclibname) THEN
  1323.   DO
  1324.     needslash = LASTPOS(':',path)
  1325.     IF ~(needslash == LENGTH(path)) THEN
  1326.       path = path'/'
  1327.     ECHO " The following indicate a hunk2gcc error:"
  1328.     ECHO " Short reloc into N_DATA, what should I do?
  1329.     ECHO " Short reloc into N_BSS, what should I do?
  1330.     ECHO ""
  1331.     ECHO ""
  1332.     ECHO " Remember to move/rename "path"object2/"gcclibname" appropriately ."
  1333.   END
  1334. ELSE
  1335.   ECHO "No library created, what could have gone wrong ????"
  1336.  
  1337. EXIT
  1338.  
  1339. ERROR:
  1340.  
  1341.    ECHO " error = "RC
  1342.    ECHO " Hope its not the dreaded *Invalid Hunk type*"
  1343. EXIT
  1344.  
  1345.     h.  Inline Headers
  1346.  
  1347. [Christian Stieber] (maybe should clear out the specific bgui reference)
  1348.  
  1349. > compiling bgui:demos/font.c:
  1350. >   gcc -O3 -noixemul bgui:demos/font.c
  1351. > 
  1352. > got errors:
  1353. >   font.c:100: unterminated macro call
  1354.  
  1355. This is because the inlined varargs aren't useful at all. Do
  1356. #define NO_INLINE_STDARG (or whatever it is called), and create
  1357. varargs stubs like this:
  1358.  
  1359. Prototype: BOOL SomeFunction(int, char *, ...);
  1360. and        BOOL SomeFunctionA(int, char *, APTR);
  1361.  
  1362. Stub function:
  1363. #define NO_INLINE_STDARG
  1364. #include <inline/someinline.h>
  1365. BOOL SomeFunction(int A, char *B, ...)
  1366. {
  1367.   return SomeFunctionA(A,B,(&B)+1);
  1368. }
  1369.  
  1370. That isn't really ANSI-C, but it works on all Amiga compilers I know of.
  1371.  
  1372. Create a .c file for every function, compile, ar and link it to
  1373. the program. Make sure the optimizer is on, else SomeFunctionA
  1374. won't be inlined.
  1375.  
  1376. How to create stubs for non-varargs functions:
  1377. In order to be able to compiler without -O, you want to create
  1378. stubs for the inline functions as well:
  1379.  
  1380. #define NO_INLINE_STDARG
  1381. #define SomeFunctionA InlinedSomeFunctionA
  1382. #include <inline/someinlines.h>
  1383. #undef SomeFunctionA
  1384. BOOL SomeFunctionA(int A, char *B, APTR C)
  1385. {
  1386.   return InlinedSomeFunctionA(A,B,C);
  1387. }
  1388.  
  1389. Again, create such a file for every function and put the *.o files
  1390. into the archive mentioned above.
  1391.  
  1392.      j. Writing Hooks
  1393.  
  1394. [Tomi Ollila]
  1395. > 1) How to I write a hook function - I.E. Specify which registers parameters
  1396. > should be received in and that the result should be returned in register D0.
  1397.  
  1398. One way to do this is to write the function entry the following way:
  1399.  
  1400. ULONG hook(void)
  1401. {
  1402.   register char * a0 __asm("a0");
  1403.   char * buffer = a0;
  1404.   register ULONG d0 __asm("d0");
  1405.   ULONG size = d0;
  1406.  
  1407.   ...
  1408.  
  1409.   return length;
  1410. }
  1411.  
  1412. We wrote some macros for AmiTCP/IP project to make it easier to write this
  1413. kind of function entries...
  1414.  
  1415. #define RAF2(funname, type1, arg1, reg1, type2, arg2, reg2) \
  1416.   funname(VOID)                     \
  1417. {                                   \
  1418.   register type1 reg1 __asm(#reg1); \
  1419.   type1 arg1 = reg1;                \
  1420.   register type2 reg2 __asm(#reg2); \
  1421.   type2 arg2 = reg2;
  1422.  
  1423.  
  1424. would make the above function look like:
  1425.  
  1426. ULONG RAF2(hook,
  1427.        char *,    buffer,    a0,
  1428.        ULONG,    size,    d0)
  1429. #if 0
  1430. {
  1431. #endif
  1432.  
  1433. The whole macro file `amiga_raf.h' is available at kampi.hut.fi, directory
  1434. /AmiTCP. It defines RAF1 - RAF7 for both GNU C and SAS C compilers (someone
  1435. could write these to DICE as well).
  1436.  
  1437.  > 2) Is there anyway to specify that a function should NOT be made inline (As
  1438.  > I wouldn't want the hook function inlined.
  1439.  
  1440. Compile it in a separate module. This way gcc doesn't see the function code
  1441. when compiling. If you give a pointer to the function, then it must also
  1442. exist as a callable function.
  1443.  
  1444.  
  1445.  
  1446.  
  1447. 5.  C++ and Objective C
  1448.  
  1449.     a. C++
  1450.  
  1451.     i)  Use _complex.h instead of complex.h
  1452.         Because Amiga Dos is not case-sensitive, and there are
  1453. both complex.h and Complex.h on the Unix distribution, one had to be
  1454. changed.  This choice was recommended by the libg++ maintainer.
  1455.  
  1456.     (don't know much about these, except that they're not as well
  1457.      developed yet as the C compiler)
  1458.  
  1459. 6.  Notes For Un*x Hackers
  1460.  
  1461.      [additions to this section are welcome]    
  1462.        a. fork() is not implemented
  1463.          
  1464.           Here's a clip from Markus Wild's README in the ixemul source
  1465. distribution:
  1466.  
  1467.  
  1468. Some notes to vfork() and friends
  1469. =================================
  1470.  
  1471. **IX/BSD process management is one of the most nasty design differences
  1472. between AmigaDOS ans **IX/BSD. `fork()' for example is hardly possible to
  1473. implement on AmigaDOS, as it requires to create an identical copy of the
  1474. parent process. This is only feasible with virtual memory, where processes
  1475. can be mapped at equal places in memory. Under AmigaDOS this would have
  1476. to be simulated by copying of stack and malloc'd data whenever a process
  1477. is activated, and copying them to a safe place before it is disactivated.
  1478.  
  1479. This problem can be avoided, if the program to be run under AmigaDOS is
  1480. only fork()ing, because it just wants to start another process. In that
  1481. case, no such copying as described before is necessary, and BSD therefore
  1482. invented the `vfork()' function, which works like `fork', but runs the 
  1483. child on the parents memory segments (stack and malloc'd data). While the
  1484. child is using the parents resources, the parent is sleeping in a not
  1485. interruptible state. 
  1486.  
  1487. That much for theory;-) I tried to implement an as compatible as possible
  1488. vfork() function, that behaves like the BSD one. This should work under
  1489. any OS version, for Kickstart 1.3 the arp.library is used, starting with
  1490. OS 2.0 dos.library is powerful enough to do it itself.
  1491.  
  1492. Since I won't try to implement `fork', I provided a possible alternative
  1493. (you tell me;-)). As an extension, you get the `vfork_resume()' function,
  1494. which causes the parent to resume, just like it would if you called 
  1495. `_exit()' or one of the `exec*()' functions. Since this function is quite
  1496. dangerous (and an even bigger hack than vfork() itself..), here's what's
  1497. happening in `vfork_resume()':
  1498.  
  1499.   o  the child switches to its own stack. After vfork(), the child is
  1500.      using the stack of the parent process. Since no two processes can
  1501.      share the same stack in parallel, vfork_resume() causes a switch
  1502.      to the `real' stack of the child.
  1503.   o  the parent is sent a wakeup message.
  1504.   o  both processes run concurrently
  1505.  
  1506. The first point is the most important one: Since vfork_resume() changes
  1507. the stack pointer of the running process, you can't refer to any variables
  1508. or parameters anymore after calling vfork_resume()! Only register
  1509. variables survive such a call, and you have to explicitly store values
  1510. in register variables that are subject to survive!
  1511.  
  1512. There's another potential problem with vfork_resume():
  1513.  
  1514. **************************************************************************
  1515.   Don't exit() from the parent before all vfork()'d children have died!!
  1516. **************************************************************************
  1517.  
  1518. Since exiting from the parent causes the parents code and data segments to
  1519. be deallocated, the child would find itself without code space to run
  1520. on, and would probably cause a severe machine crash!
  1521.  
  1522. So always call at least `wait (0)' before returning from the parent.
  1523.  
  1524.  
  1525.  
  1526. exec*()
  1527. =======
  1528.  
  1529. In most cases, you just use `vfork()' to later overlay the process with 
  1530. a new image, that is you want to start another program. The way AmigaDOS
  1531. loads processes is not too well suited to do `exec' style program starting,
  1532. yet it is possible, although with slight resource wasting.. 
  1533.  
  1534. First problem is, that all exec* functions pass an argument vector to
  1535. the new program, whereas AmigaDOS programs expect to be passed an argument
  1536. line (instead of the vector of arguments). Since in my opinion it would
  1537. be a good thing if a program could get an argument vector directly (in that
  1538. case the inherent problem of passing multi word arguments to a program would
  1539. be finally solved, no more weird quoting needed!). That's why I provided
  1540. a mechanism that allows this vector passing, and it works like this (look
  1541. at crt0.c for a concrete implementation of this concept!):
  1542.  
  1543.   The program has to provide a magic header at the first executable location
  1544.   in its code. This magic header looks like this:
  1545.      o  JMP instruction to common AmigaDOS startup
  1546.      o  struct exec area. Use the OMAGIC a_magic code.
  1547.      o  provide an alternate entry vector in a_entry. execve() jumps thru
  1548.         this vector to pass vectors to your program, instead of going
  1549.         thru the normal AmigaDOS startup part.
  1550.  
  1551. As long as you use my crt0.o and libc.a, this whole thing is completely
  1552. transparent to your program, you only have to care for it, if you want
  1553. to support the mechanism in other languages as well.
  1554.  
  1555. The second problem is how to start `old' AmigaDOS programs from execve().
  1556. If the program has the described magic header, starting is easy. Else 
  1557. another approach is taken, depending on the OS version. Common to both
  1558. OS versions (1.3 and 2.0) is redirection of stdin and stdout. Since the
  1559. new program can't refer to the real file descriptors (I can't pass the
  1560. open library without my startup code), I have to setup DOS fields to
  1561. use my filehandles. This may succeed or not, depending on whether the
  1562. descriptors in question are realized by DOS files or not (in the future
  1563. a not-compatible alternative would be descriptors that refer to sockets!).
  1564. Actual starting of the program is done with RunCommand() under 2.0, and
  1565. some own hack under 1.3. If someone is interested to get this working
  1566. well under 1.3, I'd be happy to include a better starter function, my
  1567. kludge doesn't particularly deal graceful with BCPL functions...
  1568.  
  1569.  
  1570.  
  1571.  
  1572. 7.  Support Utilities
  1573.  
  1574.     a. Frontends
  1575.  
  1576.        I'm thinking of GUI's here.  There is one (something like GCC_Frontend)
  1577. on the April 1994 Aminet CD-ROM collection.  If I remember correctly though,
  1578. when I tried using it, it bugged out on me.  Anybody know of anything else?
  1579.  
  1580.     b. Debuggers  (Maybe just GDB?)
  1581.          
  1582.           GDB is the GNU debugger, and Fred Fish is the port master for it.
  1583. Here is something from his readme.
  1584.  
  1585.  
  1586. GDB 4.12 has been ported to the extent that you can build an AmigaDOS
  1587. executable that knows how to load and examine executables from non-AmigaDOS
  1588. systems.  Much work remains.  See the gnu:src/diffs/gdb-4.12-README file.
  1589.  
  1590. [He's referring to the general gnu:source directory.  If you unpack the
  1591. gdb source archive to your GNU: directory, it should be in that same directory.]
  1592.  
  1593.  
  1594.  
  1595.     c. What else?
  1596.  
  1597. 8.  Additional Support 
  1598.  
  1599.     a. amiga-gcc-port mailing list
  1600.  
  1601.     b. snail mail (?)  - for people getting it off of CD-ROM
  1602.     
  1603.     c. You never know, it could be a problem in base FSF code
  1604.  
  1605.        gnu.gcc Newsgroup and daughter newsgroups
  1606.        ftp: prep.ai.mit.edu in /pub/gnu  is the primary archive for the GNU
  1607.         Project.  If you need the FSF baseline code for something,
  1608.         it'll be there.
  1609.  
  1610. 9.  Known Bugs
  1611.     
  1612.     a. C compiler
  1613.        
  1614.        i) -resident option
  1615.         This has been broken since 2.3.3.  Hence, you'll need to get
  1616. that version if you want to compile a program you can easily make resident.
  1617.          Of course, you can always write your code to be resident, it
  1618. just takes a little more effort (see above).
  1619.  
  1620.         This is fixed in 2.7.0.
  1621.  
  1622.        ii) -fbaserel option 
  1623.         Won't be fixed until the -resident option is (as it's the
  1624. cause of the -resident problem).
  1625.  
  1626.     b.  C++ compiler (g++)
  1627.  
  1628.     c.  Objective C compiler 
  1629.  
  1630. 10. Maintainers and Contributors
  1631.  
  1632. Gcc v2.2.2 port:   Markus Wild
  1633. Gcc v2.3.3 port:   Markus Wild
  1634. Gcc v2.4.5 port:   Philippe Brand, Lars Hecking, Fred Fish
  1635. Gcc v2.5.0 and up: Philippe Brand, Fred Fish, Leonard Norrgard 
  1636.  
  1637. Ixemul.library:    Markus Wild, Leonard Norrgard, R. Luebbert
  1638. Libnix:            Matthias Fleischer, Gunther Nikl
  1639.  
  1640. Also, much testing, suggestions and debate have been provided by
  1641. Jorg  Hoehle
  1642. Peter Ivemey-Cook
  1643. Christian Stieber
  1644. Walter Harms
  1645. Lars Hecking
  1646. Kriton Kyrimis
  1647. Niklas Hallqvist
  1648. Jochen Wiedmann
  1649. Thomas Walter
  1650.  
  1651.    not necessarily in that order.
  1652.  
  1653. [ I just compiled this list from looking at the 1995 archive and some of the
  1654. '94, whoever consistently either (a) made suggestions and wrote some code
  1655. or (b) has been reporting bugs from attempts at compiling GNU software
  1656. for a long time (i.e. not someone who's just having problems porting their
  1657. favorite package).  If I've left someone out, or if you have a problem
  1658. with my criteria, or if you think I should just thank the mailing list as
  1659. a whole, mail me].
  1660.  
  1661. The present FAQ maintainer is Lynn Winebarger (owinebar@indiana.edu).
  1662. However, you should send corrections to amiga-gcc-port@nic.funet.fi for
  1663. a look over, as that's what I'll do anyway.
  1664. [or maybe they should just send them to me, and I can screen out the 
  1665. very common screw-up from people who think they know.]
  1666. Flames directed to /dev/null.
  1667.  
  1668.  
  1669. 11. Future
  1670.  
  1671. 12. History
  1672.  
  1673. Appendix A: How does the GPL affect programs compiled by GCC?
  1674.  
  1675. [Niklas Hallqvist]
  1676.  
  1677. >    If I compile one of my sources with gcc, do I have to
  1678. > distribute it under the GPL? I'm not using any GNU libraries or
  1679. > startup or anything.  My interpretation of the GPL is that i
  1680. > don't have to, but one of the teacher (lecturers?) say that I
  1681. > have to. Who's right?
  1682.  
  1683. You are.  The GPL (and LGPL) only covers distributed code, not code
  1684. generated by tools which are GPL:ed. As there are code which get
  1685. linked by GCC distributed with GCC, libgcc.a, one might think that the
  1686. GPL would apply to generated code, but no, libgcc.a is written without
  1687. GPL just to enable that use of the GNU compiler.  Think about it,
  1688. several object-only commercial applications including OSes are
  1689. compiled by GCC for enhanced performance, would they do that if they
  1690. had to give up their objectcode-only policy?  The key behind the GPL
  1691. is that no code based on work GPLed, should be locked to to that
  1692. specific compilation, but the user should be able to customize the GPLed
  1693. code as he wants to and recompile.  You are still allowed to protect
  1694. your own source as you see fit.  For example, let's say you use som
  1695. LGPLed library libfoo.a in your application app.  When you distribute
  1696. it you must also distribute a linkable objectfile app.o which, when
  1697. linked with the distibuted libfoo.a (with source) generates app.  If
  1698. the end-user wants, he should be able to customize libfoo, and relink
  1699. it with app.o to get a customized app.  It's not a very severe
  1700. limitation on distribution rights IMHO.
  1701.  
  1702. Remember that the (L)GPL was written to give programmers more Freedom,
  1703. not to limit their chance of protecting their own work.  As long as
  1704. their own work is clearly delimited from others GPLed work, it's
  1705. perfectly OK to keep a separate copyright policy on it.
  1706.  
  1707. In your case, your lecturer has misunderstood the intentions of the
  1708. (L)GPL which is easy to do.  These discussions come up ever so often
  1709. because of the legaleze used to express the GPL.  Too bad many get the
  1710. GPL wrong, as rumours like "you cannot use GNU products for business
  1711. work" severly harms the usage of GNU products.  To name a few uses of
  1712. GCC where the program did NOT fall under the GPL:  Dell Unix SVR4,
  1713. NextStep & some OSF/1 port.  Tell your lecturer about these, and ask
  1714. him why he thinks the GPL prevents them to be sold during other than
  1715. GPL conditions?  I ask you to actually convince him he was wrong as it
  1716. is harmful for the programming society that such misconceptions exist.
  1717.  
  1718.     This is where I'd like to put that list of libraries that are GPLed.
  1719.  
  1720.  
  1721. Appendix B:  GNU Porting activities and who's dealing with them
  1722.  
  1723.     Not really GCC (Which is why it's an Appendix), but certainly one of
  1724. GCC's main uses.
  1725.       It would be good to keep track of these things anyway, in case someone
  1726. wants to start working on porting something (just as administratvia).
  1727.  
  1728.  
  1729. Appendix C:  Another Free C compiler (for those without much memory)
  1730.  
  1731.    Warning, apparently lcc is not yet fully ported (no backend) for easy
  1732. use.
  1733.  
  1734. [Fred Fish]
  1735.  
  1736. > > One of the things I hope to eventually add to my FreshFish CD is a
  1737. > > port of lcc, which is much smaller and faster than gcc, and apparently
  1738. > > somewhat more ANSI compliant.  I just haven't had time yet to look
  1739. > > at doing so.
  1740. > 
  1741. > What's lcc? I never heard of it.
  1742.  
  1743. ============================ begin inclusion ===========================
  1744.  
  1745. lcc is the retargetable compiler for ANSI C described in our book
  1746. `A Retargetable C Compiler: Design and Implementation'
  1747. (Benjamin Cummings, 1995, ISBN 0-8053-1670-1), which will be available
  1748. in December 1994. lcc is in production use at Princeton University and
  1749. AT&T Bell Laboratories.
  1750.  
  1751. The public distribution directory contains the following files.
  1752.  
  1753. README    this file.
  1754.  
  1755. install.{ps,txt}
  1756.     describes the distribution and gives installation
  1757.     instructions. install.ps is the PostScript generated from
  1758.     the HTML document, install.html, which is included in the
  1759.     the distribution.
  1760.  
  1761. X.Y.tar.{Z,gz}
  1762.     a compressed tar files for the distribution of version X.Y,
  1763.     e.g., 3.0.tar.Z the tar file compressed with compress. This
  1764.     distribution includes user documentation, the front end, the
  1765.     driver program, code generators for the SPARC, MIPS R3000 and
  1766.     x86, and the code-generator generator that produced them. A
  1767.     .gz file is the tar file compressed with gzip instead
  1768.     of compress.
  1769.  
  1770. The distribution is available via `anonymous' ftp from
  1771. ftp.cs.princeton.edu (128.112.152.13) in the directory pub/lcc.
  1772. Obtaining and extracting the distribution into its own directory is
  1773. accomplished by the following commands. Replace `3.0' with the latest
  1774. version, which is the only one typically available; versions like
  1775. `3.0a' identify minor updates and versions like `3.1beta' identify
  1776. pre-releases (which might be incomplete). As suggested, use your login
  1777. as the password, and use ftp's binary transfer mode.
  1778.  
  1779. mkdir lcc
  1780. cd lcc
  1781. ftp ftp.cs.princeton.edu
  1782. anonymous
  1783. yourlogin
  1784. cd pub/lcc
  1785. binary
  1786. get 3.0.tar.Z dist.tar.Z
  1787. quit
  1788. zcat dist.tar | tar xpof -
  1789. rm dist.tar.Z
  1790.  
  1791. To be added to the lcc mailing list, send a message with the 1-line body
  1792.  
  1793. subscribe lcc
  1794.  
  1795. to majordomo@cs.princeton.edu. This line must appear in the message
  1796. body; `Subject:' lines are ignored. To learn more about mailing lists
  1797. served by majordomo, send a message with the body `help' to
  1798. majordomo@cs.princeton.edu.
  1799.  
  1800. Additional information about lcc and about our book is available on the
  1801. WWW at URL http://www.cs.princeton.edu/software/lcc.
  1802.  
  1803.  
  1804. Chris Fraser / cwf@research.att.com
  1805. David Hanson / drh@cs.princeton.edu
  1806. Thu Aug 18 13:36:15 EDT 1994
  1807.  
  1808.  
  1809.  
  1810.